d払い決済 インタフェース
概要
リンクタイプ Plus決済では、決済手段としてd払い決済を利用することが可能です。d払い決済を利用するには、実行パラメータセットにd払い決済に必要なパラメータを渡す必要があります。
リンクタイプ Plus決済でd払い決済が完了すると、遷移先URLにd払い決済の結果パラメータが返却されます。
遷移先URLは設定により異なるパラメータを参照します。
詳細は「決済画面からの加盟店様サイトへの遷移」をご覧ください。
入出力パラメータ仕様
実行パラメータ仕様
d払い決済固有の実行パラメータは以下の通りです。
json key | 詳細 | 指定可能箇所 | システムデフォルト設定 | ||
---|---|---|---|---|---|
リンクタイプPlus決済URL | 加盟店デフォルト設定 | ||||
docomo |
d払い決済固有実行パラメータd払い決済の実行パラメータセットです。 |
〇 | 〇 | ||
JobCd |
処理区分AUTH:仮売上CAPTURE:即時売上 |
〇 | 〇 | AUTH | |
DocomoDisp1 | 全半角40バイト
ドコモ表示項目1spモードの場合のみ、以下のd払い画面に表示されます。・決済内容確認画面 ・利用明細 商品の詳細説明や、お客様へのメッセージなどにご使用ください。 改行が必要な場合は表示項目1、表示項目2に分けて設定してください。 設定可能な文字は、全角文字についてで禁止している文字に加え [ " ][ . ][ ' ][ ¥ ][ / ]以外です。 |
〇 | 〇 | (null) | |
DocomoDisp2 | 全半角40バイト
ドコモ表示項目2spモードの場合のみ、以下のd払い画面に表示されます。・決済内容確認画面 ・利用明細 商品の詳細説明や、お客様へのメッセージなどにご使用ください。 改行が必要な場合は表示項目1、表示項目2に分けて設定してください。 設定可能な文字は、全角文字についてで禁止している文字に加え [ " ][ . ][ ' ][ ¥ ][ / ]以外です。 |
〇 | 〇 | (null) | |
DispCompanyName | 全半角32バイト
会社名ドコモセンターの決済ページ及び決済結果メール等の連絡先として使用する会社名です。設定可能な文字は全角文字についてで禁止している文字に加え[ " ][ ' ][ \ ][ / ]以外です。 ※包括契約加盟店様のみ設定が可能です。 |
〇 | 〇 | (null) | |
DispShopName | 全半角32バイト
利用店舗名(※1)ドコモセンターの決済ページ及び決済結果メール等の連絡先として使用する店舗名です。DispShopName~DispShopUrlのいずれも指定しない場合は、登録されているショップ名を使用します。 設定可能な文字は、全角文字についてで禁止している文字に加え [ " ][ ' ][ ¥ ][ / ]以外です。 |
〇 | 〇 | (null) | |
DispPhoneNumber | 半角数字13桁
連絡先電話番号(※1、2)ドコモセンターの決済ページ及び決済結果メール等の連絡先として表示する電話番号です。設定可能な文字は半角数字と半角ハイフンのみです。 |
〇 | 〇 | (null) | |
DispMailAddress | 半角英数記号96桁
メールアドレス(※1、2)ドコモセンターの決済ページ及び決済結果メール等の連絡先として表示するメールアドレスです。設定可能な文字は半角英数字、[@](半角アットマーク)、[.](半角ピリオド)、[-](半角ハイフン)、[_](半角アンダースコア)のみです。 |
〇 | 〇 | (null) | |
DispShopUrl | 半角英数96桁
連絡先URL(※1、2)ドコモセンターの決済ページ及び決済結果メール等の連絡先として表示するURLです。設定可能な文字は半角英数と[ " ][ ' ][ \ ]以外の半角記号です。 なお、"/"(半角スラッシュ)は4バイトとしてカウントされます。 |
〇 | 〇 | (null) |
※2:DispPhoneNumber~DispShopUrlの設定値の合計バイト数を96バイト以内にしてください。
※設定可能な文字については「プロトコルタイプ(マルチ決済インタフェース仕様) 表 1.1-1 入出力項目の定義」を参照してください。
結果パラメータ仕様
d払い決済を選択した場合に、加盟店様に返却するd払い決済固有の結果パラメータは以下の通りです。
docomo | 半角英数32桁 固定
d払い決済固有部 |
|
---|---|---|
Status |
取引状態取引の状態を示す以下の値が設定されます。AUTH:仮売上 CAPTURE:即時売上 PAYFAIL:決済失敗(決済がエラーとなり支払いに失敗してしまった状態) UNPROCESSED:未決済(決済が完了していない状態) AUTHPROCESS:認証処理中(ドコモにて決済が処理中の状態) |
|
DocomoSettlementCode | 半角数字12桁
ドコモ決済番号オーソリ処理が正常終了した時にドコモから振り出される番号が設定されます。お客様がMy docomo画面で確認できます。 |
|
DocomoCancelAmount | 半角数字6桁
キャンセル金額キャンセル時の金額が設定されます。 |
|
DocomoCancelTax | 半角数字6桁
キャンセル税送料キャンセル時の税送料が設定されます。 |
|
DocomoIncreaseAmount | 半角数字6桁
増加金額増額時の金額が設定されます。 |
|
DocomoIncreaseTax | 半角数字6桁
増加税送料増額時の税送料が設定されます。 |
|
Trandate | 半角数字14桁
決済日時決済依頼を実施した日時が設定されます。(yyyyMMddHHmmss形式) |